Skip to main content

Visualisierungselement: Bild

Symbol:

_visu_img_picture.png

Kategorie: Basis

Das Element fügt ein Bild in die Visualisierung ein. Das angezeigte Bild wird in der Bildersammlung verwaltet und im Visualisierungselement über eine statische ID referenziert. Sie können das angezeigte Bild auch dynamisch umschalten, indem Sie anstelle der statischen ID eine Variable verwenden.

Tipp

Sie können ein Hintergrundbild für die gesamte Visulisierung mit dem Befehl Hintergrund definieren.

Tipp

Sie können die Verzeichnisse, die Bilder für die Verwendung in Visualisierungen enthalten, in den Projekteinstellungen (Kategorie Visualisierung) festlegen.

Elementeigenschaften

Sind alle Elementeigenschaften verfügbar?

Nur wenn Sie in der Eigenschaften die Option Advanced oder den Filter Alle Kategorien aktiviert haben, stehen Ihnen alle Eigenschaften zur Verfügung.

Elementname

Beispiel: Statusleiste

Tipp

Durch die Vergabe von eigenen Elementnamen werden die Elemente in der Elementliste schnell gefunden.

Elementtyp

Bild

Statische ID

Statische ID eines Bilds aus einer Bildersammlung. Die Bildersammlung kann Teil des Projekts oder aus einer Bibliothek sein. Die ID kann exakt aufgelöst werden, wenn Sie den vollständigen Instanzpfad angegeben.

Instanzpfad für ein Bild mit Bildersammlung im Projekt:

<namespace library>.<name of image pool>.< ID image>

Beispiel:

MyLib.Imagepool.background

VisuSymbols.Symbols.Phone : Instanzpfad für ein Bild mit Bildersammlung in der VisuSymbols Bibliothek

Der Namespace für die Bibliothek (namespace library) ist optional. Wenn er fehlt, wird eine Bildersammlung innerhalb des Projekts gesucht.

Der Punkt vor der Bildersammlung ( . ) ist optional. Wenn der Punkt angegeben ist markiert dies einen Instanzpfad im Projekt.

.Imagepool.background

Wenn ein Bild mit diesem Verfahren nicht gefunden werden kann, wird eine Ersatzsuche nach der Bild-ID durchgeführt. Das Ergebnis ist die erste passende Bild-ID. Bei mehrdeutigen IDs kann dies dazu führen, dass ein falsches Bild angezeigt wird. Bei einer exakten Angabe mit Instanzpfad wird dies vermieden.

Tipp

Geben Sie einen vollständigen Instanzpfad an, um Konflikte zu vermeiden:

<namespace path> . <name of image pool> . <image ID>

Für weitere Informationen siehe: Objekt Bildersammlung

Rahmen anzeigen

standard icon: Die Bilddatei wird mit einem Rahmen dargestellt.

Abschneiden

Voraussetzung: Skalierungsart ist Unskaliert

standard icon: Es wird nur der Teil der Visualisierung dargestellt, der in den Elementrahmen passt.

Transparent

standard icon: Die Pixel des Bildes, die die Transparenzfarbe haben, werden transparent dargestellt.

Transparenzfarbe

Nur wirksam, wenn Sie die Option Transparent aktiviert haben.

Die Schaltfläche _cds_icon_button_threedots.png öffnet den Farbauswahldialog. Darin wählen Sie die Farbe aus, die transparent dargestellt wird.

Skalierungsart

. Definition, wie sich das Bild in den Elementrahmen einpasst.

  • Isotropisch: Das Bild wird vollständig im Elementrahmen dargestellt und dazu vergrößert oder verkleinert. Dabei werden die Proportionen beibehalten, das Verhältnis Höhe zu Breite bleibt erhalten.

    Wenn die Ausrichtung der Elemente zueinander auch innerhalb eines skalierten Frame-Elements beibehalten werden soll, ist Folgendes zu beachten: Unerwünschte horizontale oder vertikale Verschiebungen können vermieden werden, indem die Eigenschaften Horizontale Ausrichtung und Vertikale Ausrichtung auf Zentriert gesetzt wird. Die Ausrichtung der Elemente bleibt dann erhalten und es entstehen keine horizontale und vertikale Verschiebungen.

    Beispiel: Sie haben eine Lampe zentriert oberhalb eines Schalters angeordnet. Die Lampe soll in dieser horizontal zentrierten Position bleiben, auch wenn sich die Größe des Frames verändert.

  • Anisotropisch: Das Bild passt sich der Größe des Elementrahmens an, so dass der gesamte Elementrahmen gefüllt ist. Dabei werden die Proportionen nicht beibehalten.

  • Unskaliert: Das Bild behält die Originalgröße, auch wenn sich die Größe des Elementrahmens ändert. Zu berücksichtigen ist dabei auch, ob die Option Abschneiden aktiviert ist.

    Bei jeder Neuzuweisung einer Bild-ID wird die Elementgröße auf die Bildgröße automatisch angepasst.

Horizontale Ausrichtung

. Horizontale Ausrichtung des Elements innerhalb des Elementrahmens:

  • Links

  • Zentriert

  • Rechts

Voraussetzung: Skalierungsart des Bildes ist Isotropisch oder Unskaliert.

Anmerkung

Wenn die Visualisierung referenziert wird, dann wirkt die horizontale Ausrichtung innerhalb der Frameposition.

_visu_icon_variable.png: Eigenschaft Variable erscheint darunter.

Variable

Enumerationsvariable (ENUM VisuElemBase.VisuEnumVerticalAlignment) für die horizontale Ausrichtung

Beispiel: PLC_PRG.eHorizontalAlignment

Vertikale Ausrichtung

. Vertikale Ausrichtung des Elements innerhalb des Elementrahmens:

  • Oben

  • Zentriert

  • Unten

Voraussetzung: Skalierungsart des Bildes ist Isotropisch oder Unskaliert.

Anmerkung

Wenn die Visualisierung referenziert wird, dann wirkt die horizontale Ausrichtung innerhalb der Frameposition.

_visu_icon_variable.png: Eigenschaft Variable erscheint darunter.

Variable

Enumerationsvariable (ENUM VisuElemBase.VisuEnumVerticalAlignment) für die vertikale Ausrichtung

Beispiel: PLC_PRG.eVerticalAlignment

Für die in der Tabelle oben als Beispiel verwendeten Variablen ist eine gültige Deklaration erforderlich.

Enumeration

TYPE VisuElemBase.VisuEnumHorizontalAlignment
    LEFT
    HCENTER
    RIGHT
END_TYPE

TYPE VisuElemBase.VisuEnumVerticalAlignment
    DOWN
    VCENTER
    BOTTOM
END_TYPE

Deklaration

PROGRAM PLC_PRG
VAR
    eHorizontalAlignment : VisuElemBase.VisuEnumHorizontalAlignment := VisuElemBase.VisuEnumHorizontalAlignment.HCENTER;
    eVerticalAlignment : VisuElemBase.VisuEnumVerticalAlignment := VisuElemBase.VisuEnumVerticalAlignment.VCENTER;
END_VAR

Für weitere Informationen siehe: Objekt Bildersammlung

Position

Die Position definiert die Lage und Größe des Elements im Fenster der Visualisierung. Sie bezieht sich auf ein kartesisches Koordinatensystem. Der Ursprung liegt in der oberen linken Fensterecke. Die positive horizontale X-Achse verläuft nach rechts. Die positive vertikale Y-Achse verläuft nach unten.

X

X-Koordinate (in Pixel) der linken oberen Ecke des Elements

Beispiel: 10

Y

Y-Koordinate (in Pixel) der linken oberen Ecke des Elements

Beispiel: 10

Breite

Breite (in Pixel)

Beispiel: 150

Höhe

Höhe (in Pixel)

Beispiel: 30

Tipp

Die Werte können auch geändert werden, indem Sie im Editor die Symbole _visu_icon_position_element.png an eine andere Stelle ziehen.

Winkel

Statischer Drehwinkel (in Grad)

Beispiel: 35

Das Element wird im Editor gedreht dargestellt. Rotationspunkt ist das Zentrum des Elements. Ein positiver Wert bewirkt eine Rechtsdrehung.

Tipp

Sie können den Wert im Editor ändern, indem Sie das Element am Griff fokussieren. Wenn der Cursor daraufhin als Drehpfeil _visu_icon_rotate_statically.png dargestellt wird, können Sie das Element wie am Griff haltend um sein Zentrum drehen.

_visu_img_selected_image_with_handle.png

(1): Griff

Anmerkung

Wenn zusätzlich in der Eigenschaft Absolute Bewegung → Innere Rotation ein dynamischer Drehwinkel konfiguriert ist, werden zur Laufzeit der statische und der dynamische Drehwinkel addiert. Der statische Drehwinkel fungiert als Offset.

Zentrum

Die Eigenschaften enthalten feste Werte für die Koordinaten des Rotationspunkts. Der Rotationspunkt ist im Editor als Symbol _visu_icon_center_point.png dargestellt und dient als Zentrum für die Rotation und die Skalierung.

Tipp

Die Werte können auch geändert werden, indem Sie im Editor das Symbol _visu_icon_center_point.png an eine andere Stelle ziehen.

X

X-Koordinate des Rotationspunkts

Y

Y-Koordinate des Rotationspunkts

Farben

Die Eigenschaften enthalten feste Werte um die Farben zu setzen.

Farbe

Voraussetzung: Eigenschaft Rahmen anzeigen ist aktiviert

Farbe für den Rahmen

Anmerkung

Der Normalzustand ist gegeben, wenn der Ausdruck in der Eigenschaft: Farbvariablen → Farbumschlag nicht definiert ist oder den Wert FALSE hat.

Voraussetzung: Eigenschaft Rahmen anzeigen ist aktiviert

Farbe für den Rahmen im Alarmzustand

Anmerkung

Der Alarmzustand ist gegeben, wenn der Ausdruck in der Eigenschaft: Farbvariablen → Farbumschlag den Wert TRUE hat.

Transparenz

Transparenzwert (255 bis 0), der die Durchsichtigkeit der zugehörigen Farbe festlegt

Beispiel:

255: Farbe ist deckend

0: Farbe ist voll transparent

Anmerkung

Wenn die Farbe eine Stilfarbe ist und bereits einen Transparenzwert enthält, ist diese Eigenschaft schreibgeschützt.

Aussehen

Die Eigenschaften enthalten feste Werte um das Aussehen des Elements zu setzen.

Linienstärke

Wert in Pixel

Beispiel: 2

Anmerkung

Die Werte 0 und 1 führen beide zu einer Linienstärke von einem Pixel. Wenn keine Linie dargestellt werden soll, muss die Eigenschaft Linienart auf die Option Unsichtbar gesetzt sein.

Linienart

Art der Liniendarstellung

  • Durchgezogen

  • Striche

  • Punkte

  • Strich Punkt

  • Strich Punkt Punkt

  • Unsichtbar

Tipp

Unter der Eigenschaft Aussehensvariablen können Sie Variablen zuweisen, um das Aussehen dynamisch zu steuern. Dann werden die festen Werte hier überschrieben.

Texte

Text

Zeichenfolge (ohne einfache Anführungszeichen)

Beispiel: Accesses: %i

Das Element wird mit diesem Text beschriftet. Wenn im Text ein Platzhalter %<format string> angegeben ist, wird an der Stelle des Platzhalters der Wert der Variable in Eigenschaft Textvariable → Text ausgegeben.

Tooltip

Zeichenfolge (ohne einfache Anführungszeichen)

Beispiel: Number of valid accesses %n

Der Text wird als Tooltip ausgegeben. Wenn im Text ein Platzhalter %<format string> angegeben ist, wird an der Stelle des Platzhalters der Wert der Variable in Eigenschaft Textvariable → Tooltip ausgegeben.

Tipp

Mit dem Tastaturkürzel Strg + Eingabe fügen Sie einen Zeilenumbruch ein.

Tipp

Die eingegebenen Texte werden automatisch in die Textliste GlobalTextList übernommen. Somit können diese Texte lokalisiert werden.

Bild-ID-Variable

Bild-ID

Variable (STRING) für die Bild-ID

Beispiel: PLC_PRG.stImageID

Applikationscode: PLC_PRG.stImageID := 'ImagePool_A.Bild3';

Der Variablenwert verweist formal auf ein bestimmtes Bild einer Bildersammunder und entspricht dem Wert in der Eigenschaft Statische ID.

Texteigenschaften

Die Eigenschaften erhalten feste Werte für die Texteigenschaften und wirken auf die Texte, die in Texte → Text oderTexte → Tooltip konfiguriert sind.

Horizontale Ausrichtung

Horizontale Ausrichtung des Texts innerhalb des Elements

Vertikale Ausrichtung

Vertikale Ausrichtung des Texts innerhalb des Elements

Textformat

. Definition, wie zu lange Texte dargestellt werden

  • Default: Zu langer Text wird abgeschnitten

  • Zeilenschaltung: Text wird in mehrere Zeilen umgebrochen

  • Auslassungspunkte: Der sichtbare Text endet mit „…“ und zeigt somit an, dass er nicht vollständig ist.

Schriftart

Beispiel: Standard

_cds_icon_three_dots.png: Dialog Schriftart öffnet sich

_cds_icon_arrow_down.png: Auswahlliste mit Stilschriftarten

Farbe Schriftart

Beispiel: Schwarz

_cds_icon_three_dots.png: Dialog Farbe öffnet sich

_cds_icon_arrow_down.png: Auswahlliste mit Stilfarben

Transparenz

Ganze Zahl (Wertebereich von 255 bis 0)

Der Transparenzwert bestimmt die Durchsichtigkeit der zugehörigen Farbe.

255: Farbe ist deckend

0: Farbe ist voll transparent

Anmerkung

Wenn die Farbe eine Stilfarbe ist und bereits einen Transparenzwert enthält, ist diese Eigenschaft schreibgeschützt.

Dynamisches Bild

Mit Hilfe der Elementeigenschaft können Sie eine Reihe von Biiddateien animieren.

Bitmap-Version

Variable (ganzzahliger Datentyp), die die Version des Bildes enthält

Wenn die Variable sich ändert, liest die Visualisierung das in Eigenschaft Bild-Id referenzierte Bild neu ein und zeigt es an.

Die Visualisierung stellt bewegte Bilder dar, wenn die Bilddatei auf der Steuerung ständig aktualisiert und dabei die Versionsvariable erhöht wird. Dazu muss die Applikation so programmiert sein.

. Mögliche Anwendungsfälle

  • Anzeige von Grafiken, die von der Applikation generiert werden

  • Anzeige von Bildern, die beispielsweise über eine Kamera aktualisiert werden

Absolute Bewegung

Die Eigenschaften enthalten IEC-Variablen, um die Position des Elements dynamisch zu steuern. Bezugspunkt ist die linke obere Ecke des Elements. Zur Laufzeit wird das Element als Ganzes bewegt.

Bewegung

X

  • Variable (numerischer Datentyp) für die X-Position in Pixel

    Beispiel PLC_PRG.iPos_X

  • Containervariable Container.Width

    Für weitere Informationen siehe: Position und Größe optimal anpassen

Ein Erhöhen des Werts zur Laufzeit führt zu einer Bewegung nach rechts.

Y

  • Variable (numerischer Datentyp) für die Y-Position in Pixel

    Beispiel PLC_PRG.iPos_Y

  • Containervariable Container.Height

    Für weitere Informationen siehe: Position und Größe optimal anpassen

Ein Erhöhen des Werts zur Laufzeit führt zu einer Bewegung nach unten.

Rotation

Variable (numerischer Datentyp) für den Drehwinkel in Grad

Beispiel PLC_PRG.iAngle1.

Der Mittelpunkt des Elements rotiert um den Punkt in Zentrum. Dieser Rotationspunkt wird im Editor als Symbol _visu_icon_center_point.png dargestellt.

Zur Laufzeit bleibt die Ausrichtung des Elements in Bezug zum Koordinatensystem der Visualisierung erhalten. Ein Erhöhen des Werts führt zu einer Rechtsdrehung.

_visu_img_prp_rotation.png

Skalierung

Variable (ganzzahliger Datentyp), um eine zentrische Streckung zu bewirken

Beispiel PLC_PRG.iScaling

Bezugspunkt ist die Eigenschaft Zentrum.

Der Wert 1 verkleinert das Element um den Faktor 0.001. Der Wert 1000 belässt das Element in Originalgröße.

Innere Rotation

Variable (numerischer Datentyp) für den Drehwinkel in Grad

Beispiel: PLC_PRG.iAngle2.

Zur Laufzeit rotiert das Elements entsprechend dem Variablenwert um den Rotationspunkt in Zentrum. Zudem dreht die Ausrichtung des Elements bezüglich des Koordinatensystems der Visualisierung. Ein Erhöhen des Werts im Code bewirkt eine Rechtsdrehung.

Der Rotationspunkt wird im Editor als Symbol _visu_icon_center_point.png dargestellt.

Anmerkung

Wenn in der Eigenschaft Position → Winkel ein statischer Drehwinkel angegeben ist, wird bei der Visualisierungsausführung zum variablen Drehwinkel der statische Drehwinkel addiert (Offset).

_visu_img_prp_inner_rotation.png

Tipp

Sie können die Variablen mit einer Einheitenumrechnung kombinieren.

Tipp

Die Eigenschaften X, Y, Rotation und Innere Rotation werden von der Funktionalität „Client-Animation“ unterstützt.

Relative Bewegung

Die Eigenschaften enthalten Variablen, um das Element zu verschieben. Bezugspunkt ist die Position des Elements (Eigenschaft Position). Das Element kann dadurch seine Form ändern.

Bewegung oben links

X

  • Variable (Ganzzahliger Datentyp) für die Anzahl in Pixel, um die die linke Kante horizontal verschoben wird

    Beispiel : PLC_PRG.iDeltaX

Eine schrittweise Erhöhung des Werts führt zu einer Bewegung nach rechts.

Y

  • Variable (Ganzzahliger Datentyp) für die Anzahl in Pixel, um die die obere Kante vertikal verschoben wird

    Beispiel : PLC_PRG.iDeltaY

Eine schrittweise Erhöhung des Werts führt zu einer Bewegung nach unten.

Bewegung unten rechts

X

  • Variable (Ganzzahliger Datentyp) für die Anzahl der Pixel, um die die rechte Kante horizontal verschoben wird

    Beispiel : PLC_PRG.iDeltaWidth

  • Containervariable Container.Width

    Für weitere Informationen siehe: Position und Größe optimal anpassen

Eine schrittweise Erhöhung des Werts führt zu einer Bewegung nach rechts.

Y

  • Variable (Ganzzahliger Datentyp) für die Anzahl der Pixel, um die die untere Kante vertikal verschoben wird

    Beispiel : PLC_PRG.iDeltaHeight

  • Containervariable Container.Height

    Für weitere Informationen siehe: Position und Größe optimal anpassen

Eine schrittweise Erhöhung des Werts führt zu einer Bewegung nach unten.

Textvariablen

Textvariable

Variable (Datentyp konform mit der Formatierungsangabe) für den Platzhalter in der Eigenschaft: Texte → Text

Beispiel: PLC_PRG.iAccesses

Der Variablenwert ersetzt den Platzhalter im Text des Elements. Zur Laufzeit wird das Element mit dem Text beschriftet, wobei der Variablenwert ständig aktualisiert wird.

Anmerkung

Wenn Sie hier eine Variable vom Typ einer textlistenunterstützten Enumeration angeben, wird automatisch hinter dem Variablennamen in spitzen Klammern der Name des Enumerationsdatentyps hinzugefügt. Beispiel: PLC_PRG.enVar <enumeration name>. Dann erscheint bei der Textausgabe anstelle des numerischen Werts der Enumerationskomponente der symbolische Wert. Sehen Sie hierzu die Hilfeseite zu Enumerationen.

Tooltipvariable

Variable (Datentyp konform mit der Formatierungsangabe) für den Platzhalter in der Eigenschaft: Texte → Tooltip

Beispiel: PLC_PRG.iAccessesInTooltip

Der Variablenwert ersetzt den Platzhalter im Tooltip des Elements. Zur Lauzeit wird der Tooltip ausgegeben, wobei der Variablenwert ständig aktualisiert wird.

Dynamische Texte

Dynamische Texte sind variabel indizierte Texte einer Textliste. Zur Laufzeit wird der Text ausgegeben, der aktuell in der Variablen indiziert ist.

Textliste

. Name der Textliste

  • Als Variable (STRING)

  • Als fester Stringliteral mit einfachen Anführungszeichen

    Beispiel: 'Errorlist'

_cds_icon_arrow_down.png: Auswahlliste mit den im Projekt verfügbaren Textlisten

Hinweis: Wenn eine Textliste aus dem Projekt an eine Visualisierung in einer Bibliothek übergeben wird, muss ein Punkt vor den Namen der Textliste angehängt werden.

Textindex

. Textlisten-ID, die auf den gewünschten Ausgabetext verweist

  • Als fester String mit der ID in einfachen Anführungszeichen

    Beispiel: '1'

  • Als Variable (STRING), um die Textausgabe dynamisch zu steuern

    Beispiel: strTextID

    Beispiel Zuweisung: PLC_PRG.strTextID := '1';

Tooltipindex

. Textlisten-ID, die auf den gewünschten Ausgabetext verweist

  • Als fester String mit der ID in einfachen Anführungszeichen

    Beispiel: '2'

  • Als Variable (STRING). um die Textausgabe dynamisch zu steuern

    Beispiel: strToolTipID

    Beispiel Zuweisung: PLC_PRG.strToolTipID := '2';

Farbvariablen

Die Elementeigenschaft wird als Schnittstelle für Projektvariablen verwendet, um zur Laufzeit Farben dynamisch zu steuern.

Farbumschlag

Die Eigenschaft steuert zur Laufzeit den Farbumschlag.

. Wertebelegung:

  • FALSE: Element wird mit der in Eigenschaft Farbe angegebenen Farbdefinition dargestellt.

  • TRUE: Element wird mit der in Eigenschaft Alarmfarbe angegebenen Farbdefinition dargestellt.

. Belegung der Eigenschaft:

  • Platzhalter für die Benutzereingabevariable

    • <Umschalten-/Tastenvariable>

    • <NOT Umschalten-/Tastenvariable>

    Dabei wird der Farbumschlag nicht mit einer eigenen Variablen gesteuert, sondern mit einer Benutzereingabevariable.

    Anmerkung

    Geben Sie in der Eingabekonfiguration des Elements für die Mausklickereignisse Umschalten oder Tasten eine Variable an, erst dann ist der Platzhalter gesetzt. Wenn sowohl in Umschalten als auch in Tasten eine Variable angegeben ist, wird die in Tasten angegebene Variable verwendet.

    Tipp

    Klicken Sie auf das Symbol _visu_icon_linked_variable.png, um den Platzhalter <Umschalten-/Tastenvariable> einzufügen. Wenn allerdings die Eigenschaft Eingabekonfiguration, FALSE Tasten aktiviert ist, erscheint der Platzhalter <NOT Umschalten-/Tastenvariable>.

  • Instanzpfad einer Projektvariablen (BOOL)

    Beispiel: PLC_PRG.xColorIsToggeled

    Anmerkung

    Deklarieren und implementieren Sie im Code die hier angegebene Variable. Deren Wertebelegung bestimmt, wann die Farbe umschlägt.

Farbe

Farbvariable für den Rahmen

  • Variable (DWORD) für die Farbe

    Beispiel: PLC_PRG.dwColor

  • Farbliteral

    Beispiel Grau, deckend: 16#FF888888

Voraussetzung: Eigenschaft Rahmen anzeigen ist aktiviert.

Anmerkung

Der Normalzustand ist gegeben, wenn der Ausdruck in der Eigenschaft Farbvariablen → Farbumschlag nicht definiert ist oder den Wert FALSE hat.

Alarmfarbe

Farbvariable für den Rahmen im Alarmzustand

  • Variable (DWORD) für die Alarmfarbe

    Beispiel: PLC_PRG.dwAlarmColor

  • Farbliteral

    Beispiel Rot, deckend: 16#FFFF0000

Anmerkung

Der Normalzustand ist gegeben, wenn der Ausdruck in der Eigenschaft Farbvariablen → Farbumschlag nicht definiert ist oder den Wert TRUE hat.

Tipp

Der Transparenzanteil des Farbwertes wird nur ausgewertet, wenn im Visualisierungsmanager die Option Semitransparentes Zeichnen aktivieren aktiv ist.

Tipp

Aktivieren Sie in der Eigenschaften in der Symbolleiste des die Option Erweitert. Dann sind alle Elementeigenschaften sichtbar.

Aussehensvariablen

Die Eigenschaften enthalten Variablen, um das Aussehen des Elements dynamisch zu steuern.

Linienstärke

Variable (ganzzahliger Datentyp) für die Linienstärke in Pixel

Anmerkung

Die Werte 0 und 1 führen beide zu einer Linienstärke von einem Pixel. Wenn keine Linie dargestellt werden soll, muss die Eigenschaft Linienart auf die Option Unsichtbar gesetzt sein.

Linienart

Variable (DWORD) für die Linienart

. Codierung:

  • 0: Durchgezogene Linie

  • 1: Gestrichelte Linie

  • 2: Gepunktete Linie

  • 3: Liniendarstellung „Strich Punkt“

  • 4: Liniendarstellung „Strich Punkt Punkt“

  • 8: Unsichtbar: Die Linie wird nicht gezeichnet

Tipp

Unter der Eigenschaft Aussehen können feste Werte gesetzt sein, die zur Laufzeit von den dynamischen Variablen überschrieben werden.

Schriftartvariablen

Die Variablen ermöglichen die Darstellung der Texte dynamisch zu steuern.

Schriftname

Variable (STRING) für die Schriftart des Textes

Beispiel: PLC_PRG.stFontVar := 'Arial';

Tipp

Welche Schriftarten zur Verfügung stehen, finden Sie im Standarddialog Schriftart.

Größe

Variable (Numerischer Datentyp) für die Schriftgröße in Pixel oder Punkten

Die verwendete Einheit ist hinter dem Variablennamen in spitzen Klammern angegeben.

  • <pt> : Punkte (Voreinstellung)

    Beispiel: PLC_PRG.iFontHeight <pt>

    Code: iFontHeight : INT := 12;

  • <px> : Pixel

    Beispiel: PLC_PRG.iFontHeight <px>

    Code: iFontHeight : INT := 19;

Tipp

Die Größe einer Schriftart ist in Punkten angegeben (Beispiel: Arial 12). Verwenden Sie die Einheit Punkte, wenn die variable Schriftgröße zu einer Schriftart passen soll, beispielsweise wenn in der Eigenschaft Texteigenschaft → Schriftart eine Schriftart eingestellt ist.

Tipp

Wenn Sie in das Wertefeld klicken, erscheint dort rechts die Auswahlliste _cds_img_dropdownlist_unit_font_size.png, mit der Sie die Einheit umstellen können.

Flags

Variable (DWORD) für die Flags, um die Schriftartdarstellung zu bestimmen

. Flags:

  • 1: Kursiv

  • 2: Fett

  • 4: Unterstrichen

  • 8: Durchgestrichen

Anmerkung

Sie können die Schriftartdarstellungen kombinieren, indem Sie die Codierung der Flags addieren. Zum Beispiel ein fetter und unterstrichener Text: PLC_PRG.dwFontType := 6;

Zeichensatz

Variable (DWORD) für die Zeichensatznummer der Schriftart

Die Auswahl an Zeichensatznummern entspricht der Einstellung Skript des Standarddialogs Schriftart.

Farbe

Variable (DWORD) für die Farbe des Texts

Beispiel: PLC_PRG.dwColorFont:= 16#FF000000;

Flags für Textausrichtung

Variable (Ganzzahliger Datentyp) für die Codierung zur Textausrichtung

Beispiel: PLC_PRG.dwTextAlignment

. Codierung:

  • 0: Oben links

  • 1: Horizontal zentriert

  • 2: Rechts

  • 4: Vertikal zentriert

  • 8: Unten

Anmerkung

Sie können die Textausrichtungen kombinieren, indem Sie die Codierung der Flags addieren. Zum Beispiel ein vertikal und horizontal zentrierter Tex: PLC_PRG.dwFontType := 5;

Tipp

Feste Werte für die Darstellung der Texte sind in den Texteigenschaften gesetzt.

Zustandsvariablen

Die Variablen steuern dynamisch das Verhalten des Elements.

Unsichtbarkeit

Variable (BOOL) für das Umschalten der Sichtbarkeit des Elements

TRUE: Das Element ist zur Laufzeit nicht sichtbar.

Beispiel: bIsVisible mit VAR bIsVisible : BOOL := FALSE; END_VAR

Eingaben deaktivieren

Variable (BOOL) für das Umschalten der Bedienbarkeit des Elements

TRUE: Benutzereingaben zur Laufzeit haben keine Auswirkung. Das Element wird deaktiviert angezeigt.

Tipp

Die Eigenschaft Unsichtbarkeit wird von der Funktionalität „Client-Animation“ unterstützt.

Eingabekonfiguration

Die Eigenschaften enthalten die Konfigurationen für die Benutzereingabe bei Mausbedienung oder Tastaturbedienung. Eine Benutzereingabe ist aus der Sicht des Elements ein Eingabeereignis.

Die Schaltfläche Konfigurieren öffnet den Eingabekonfiguration, um eine Benutzereingabekonfiguration zu erstellen oder zu bearbeiten.

Eine Konfiguration enthält für das zugehörige Eingabeereignis eine oder mehrere Eingabeaktionen. Bereits erstellte Eingabeaktionen erscheinen darunter.

Beispiel: ST-Code ausführen: _visu_icon_action.png PLC_PRG.i_x := 0;

OnDialogClosed

Eingabeereignis: Ein Benutzer schließt einen Dialog.

OnMouseClick

Eingabeereignis: Ein Benutzer fokussiert das Element und führt darauf einen vollständigen Mausklick aus. Er drückt die Maustaste und gibt sie wieder frei.

OnMouseDown

Eingabeereignis: Ein Benutzer fokussiert das Element und drückt die Maustaste.

OnMouseEnter

Eingabeereignis: Ein Benutzer zieht den Mauszeiger auf das Element.

OnMouseLeave

Eingabeereignis: Ein Benutzer zieht den Mauszeiger von einem Element weg.

OnMouseMove

Eingabeereignis: Ein Benutzer bewegt den Mauszeiger innerhalb des Elementbereichs.

OnMouseUp

Eingabeereignis: Der Benutzer lässt die Maustaste innerhalb des Elementbereichs los.

OnValueChanged

Ereignis, das durch eine Wertänderung Folgeaktionen auslöst

Welche Folgeaktionen ausgelöst werden, wird im Dialog Eingabekonfiguration konfiguriert.

Die festgelegten Folgeaktionen und die jeweils dazugehörige Konfiguration werden unterhalb der Elementeigenschaft angezeigt.

Das Ereignis OnValueChanged kann durch das Compiler-Define VISU_NO_VALUECHANGED im Eigenschaftendialog der Applikation deaktiviert werden.

Tastaturkürzel

Tastaturkürzel auf dem Element, um bestimmte Eingabeaktionen auszulösen

Bei Eintreten des Tastaturkürzel-Ereignisses werden die unter der Eigenschaft Ereignis(se) angegebenen Eingabeaktionen ausgelöst.

Taste

Taste, bei dessen Drücken eine Eingabeaktion folgt

Beispiel: T

Ereignis(se)

  • Keine Aktion

  • MouseDown-Aktion: Ein Drücken der Taste löst die Eingabeaktionen aus, die in der Eigenschaft OnMouseDown konfiguriert sind.

  • MouseUp-Aktion: Ein Freilassen der Taste löst die Eingabeaktionen aus, die in der Eigenschaft OnMouseUp konfiguriert sind.

  • MouseDown/MouseUp-Aktion: Ein Drücken und Loslassen der Taste löst die Eingabeaktionen aus, die in der Eigenschaft OnMouseDown und OnMouseUp konfiguriert sind.

Umschalten

standard icon: Kombination mit Umschalttaste

Beispiel: Umschalt + T

Steuerung

standard icon: Kombination mit Steuerungstaste

Beispiel: Strg + T

Alt

standard icon: Kombination mit Alt-Taste

Beispiel Alt + T

Tipp

In der Registerkarte Tastaturkonfiguration sind alle Tastaturkürzel und deren Folgeaktionen aufgelistet, die in der Visualisierung konfiguriert sind.

Animation

Tipp

Diese Eigenschaften sind nur verfügbar, wenn Sie im Visualisierungmanager die Option Client-Animationen und Überlagerung systemeigener Elemente unterstützen aktiviert haben.

Animationsdauer

Vairable für die Dauer in Millisekunden, in der das Element eine Animation ausführt

  • Variable (Ganzzahliger Wert)

    Beispiel: Menu.tContent mit VAR tContent : INT := 500; END_VAR

  • Ganzzahliges Literal

    Beispiel: 500

. Animierbare Eigenschaften:

  • Absolute Bewegung, Bewegung, X, Y

  • Absolute Bewegung, Rotation

  • Absolute Bewegung, Innere Rotation

  • Absolute Bewegung, Äußere Rotation

Die animierte Bewegung wird ausgeführt, wenn mindestens ein Wert einer animierbaren Eigenschaft geändert wird. Die dann ausgeführte Bewegung ist nicht ruckartig, sondern wird reibungslos in der angegebenen Animationsdauer ausgeführt. Das Visualisierungselement fliegt die Sollposition an und rotiert dabei dynamisch. Die Übergänge sind fließend.

In den Vordergrund bringen

Variable (BOOL) für das Stellen des Elements in den Vordergrund

TRUE: Das Visualisierungselement wird zur Laufzeit im Vordergrund dargestellt.

FALSE: Das Visualisierungselement wird zur Laufzeit in der Ebene dargestellt, in der es im Visualisierungseditor eingefügt wurde.

Beispiel: bIsInForeground mit VAR bIsInForeground : BOOL := FALSE; END_VAR

Zugriffsrechte

Anmerkung

Nur verfügbar, wenn eine Benutzerverwaltung für die Visualisierung eingerichtet ist.

Schaltfläche Zugriffsrechte

Öffnet den Dialog Zugriffsrechte. Dort können Sie die Zugriffsrechte für das Element ändern.

. Statusmeldungen:

  • Nicht gesetzt. Alle Rechte: Zugriffsrecht für alle Benutzergruppen: bedienbar

  • Rechte sind vergeben: eingeschränkte Rechte: Mindestens für eine Gruppe ist der Zugriff eingeschränkt

In diesem Abschnitt: